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A METHOD AND APPARATUS FOR MANAGEMENT 
OF AN AUTOMATED LICENSE INSTALLATION 

FTELD OF THE INVENTION 

The present invention relates to improvements to a 
method and apparatus for the management of an automated 
license installation, and more particularly, to a method and 
apparatus for an automated license daemon and database 
interface in a three-tiered client server management system 
allowing for automated license installation. 

BACKGROUND INFORMATION 

In many cases, before programs and/or applications 
can be downloaded over the Internet by a user/client, that 
user/client is often required to provide personal information 
to allow a validation of sorts to use the program/ application . 
This is especially true where the program and/or application 
is proprietary. Collection of such personal information, via 
the Internet, telephone, or by some other means, often 
requires manual entry of the information, with such manual 
entry prone to errors. 

Where the program/ application is proprietary and a 
license is required for its use, errors from manual entry of 
data can cause disruptions and/or delays in the use of the 
program/ application. Correction of such disruptions and/or 
delays must also be done manually, is time-consuming and often 
cannot be done at night or on the weekends. Accordingly, such 
disruptions and/or delays are injurious to licensor/licensee 
business relations. 
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SUMMARY OF THE INVENTION 

According to the present invention, both a method 
and an apparatus of/for managing an automated license 
installation for user computing equipment is provided. 
According to the method of the present invention, at least one 
license installation option is provided to the user/client and 
license information of the user/client server is retrieved 
from a license database. The user/client server is queried on 
a configuration of the retrieved license information and the 
retrieved license information is confirmed with the 
user/client server. Also according to the method of the 
present invention, a license file relating to the confirmed 
license information is installed. According to the apparatus 
of the present invention, a Setup program is provided which 
resides on the user/client server. Also provided is an 
automated license Daemon program with which the Set-up program 
communicates, and a license database on which is stored 
license information and from which at least one license can be 
retrieved and then installed on the user/client server. 

The present invention, including its features and 
advantages, will become more apparent from the following 
detailed description with reference to the accompanying 
drawings . 

- BRIEF DESCRIPTION OF THE DRAWINGS 

Figures 1, 2, 3, 4, 5 and 6 illustrate a flow chart of a Setup 
program incorporating code which allows a customer to 
configure and request licenses from an automated license 
Daemon, according to an embodiment of the present invention. 

Figure 7 illustrates an apparatus by which a client may 
request and receive a license download through the Setup 
program from the automated license Daemon, according to an 
embodiment of the present invention. 
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DETAILED DESCRIPTION 

Figures 1 through 7 show a method and apparatus for 
an automated license installation by which a Setup program 
residing on a user/client computing system connects to an 
automated license Daemon and database residing on a 
program/ application download server. It is to be understood, 
of course, that the Setup program may be programmed in any 
computer language such as, for instance, C, C++, and TCL . 

According to the present invention, the Setup 
program uses a web server tunneling agent to directly connect 
through a bi-directional socket connection with a program/ 
application download server without the use of a web browser 
or the need to go through a third-party server. HTTP 
tunneling is well-known in the art, and allows messages and 
web pages to be passed back and forth through a dedicated 
Internet server port. A direct socket connection through the 
use of HTTP tunneling allows a customer to configure 
downloading based on a data store that is in an Enterprise 
Resource Planning (ERP) system. Further, a user is able to 
use a set-up graphical user interface to configure and receive 
an ERP generated license file that is tied to the current 
host, or a license file that allows the host to serve 
* floating" licenses . 

The Setup program incorporates a code to unlock and 
install programs/applications from a CD ROM or other media, or 
to request programs/applications from the program/ application 
download server. The program/application download server 
includes, in this case, an automated license Daemon. Upon a 
bi-direction socket connection through the HTTP tunneling 
operation, a request is sent and validated by a connected 
license database. Upon receipt of the license download 
request and validation, the Setup program residing upon the 
user/client computing system will receive a license file 
(i.e., a license to run/use a corresponding software 
application) , and a new configuration is then entered into the 

NY01 297729 v 1 3 



ERP database. 



The Setup program acts as a client program which 
sends user information (e.g., such as user name, company name, 
license (s) assigned, hostName, host ID, etc.) to the 
program/application download server and receives back items 
.(e.g., such as error message (s) , license file, etc.). The 
automated license Daemon, on the other hand, is a multi- 
threaded program running continuously on the program/ 
application download server, in a fashion that is bootstrapped 
to the server so that the Daemon runs whenever the server re- 
boots. The automated license Daemon is responsible for, among 
other things: receiving a request type from the Setup program; 
forwarding that request type to the appropriate handler 
threads; sending filtered information in the form of SQL 
queries to the license database; receiving a license file or 
error codes from the license database (after validation) ; 
sending the license file to the Setup program; and sending an 
error message to the Setup program if validation fails. 

Referring now to Figure 1, a user wishing to utilize 
the automated license installation will start the Setup 
program on the user/client's computing system and in step 5 
will see the welcome screen of the Setup program. In step 10, 
the Setup program will offer the user three license management 
installment options. The first option is a full installation 
option, the second option is a program group installation, and 
the third option is a floating license server installation 
option. 

Should the user decide to choose either the full 
installation option or the program group option, in step 15 
license management options are presented. In this step the 
user will be given the option to configure license management 
for a single end-user on a network or to configure license 
management for a node-locked license use. Configuration for 
the single-end user on the network would allow a local server 
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(i.e. at the customer site) to distribute the appropriate 
licensed software, while configuration for a node-locked 
license would indicate restriction to one machine without a 
network. 

Referring now to Figure 2, if the user chooses to 
configure license management for a single end user on a 
network, the code to determine the contents of the license 
management license file variable (e.g., LM_LICENSE_F.ILE) is 
entered. In step 20 then, the user is prompted for permission 
to query the license database. In this step, the user is 
being asked whether to allow the Setup program to query the 
program/ application download server to obtain license 
information regarding the user's computing equipment. If in 
step 25 the user does not wish to allow the Setup program to 
conduct such a query, in step 30 the license management 
application will exit. Additional instructions can be given 
to check with a system administrator to obtain the user's 
server host and port number being used so that the appropriate 
license management license file variable can be set to the 
proper setting. If, however, in step 25 the user allows the 
Setup program to query the program/ application download 
server, in step 35 the Setup program queries the license 
database to get all authorized local server hosts (e.g., more 
than one server may be involved as more than one project 
utilizing licensed software may be involved) . As shown in 
this figure, such query is made of the license database, which 
returns license configuration information such as host ID'S, 
port numbers, host names, products licensed, licenses used, 
etc., that is stored in the database. 

Upon retrieval from the license database of the 
pertinent information, in step 40 the Setup program runs a 
license management configuration page. Configuration consists 
of a list box displaying available hosts and license details, 
and allows the user to control adding and/or removing of 
hosts. In step 45, the license management diagnostic program 
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(lmdiag) is run on the selected host. If the license 
management diagnostic program fails in step 50, a dialog box 
presents that Setup has detected that a license management 
daemon is not running on the selected host, and the Setup 
program returns to the license management configuration as in 
step 40. If, on the other hand, the license management 
diagnostic program run of step 45 is okay, in step 55 a 
determination of the type of host of the selected host is 
conducted. If the current host is determined to be a Windows® 
type host, in step 60 license management registration begins. 
The Setup program then writes the license information into the 
Windows® registry of the selected host as is accomplished in 
step 65. Upon accomplishment of writing license information 
to the registry, or upon a determination that the current host 
is a Unix® type host, in step 70 license management is 
finished. The user is presented with a message that license 
management has been successfully configured. On Unix® hosts, a 
message reminds the user to set the license management license 
file environment variable (e.g., LM_LICENSE_FILE) , while on 
Windows® hosts, the license management license file environment 
variable is set in the Windows® registry. The program then 
exits. It is to be understood, of course, that the host types 
utilized herein are exemplary, and that other types of hosts 
may be utilized, such as Linux®, Mac®, etc.. 

Referring back to Figure 1, if in step 15, however, 
the user chose the license management option of a node locked 
variety, in step 75 it is determined whether or not an outside 
connection over the Internet exists. If no outside Internet 
connection exists, an error message is presented and the Setup 
program exists. Alternatively, if an outside Internet 
connection is determined to exist, in step 80 the Setup 
program asks for permission to conduct a database query. In 
this case, the Setup program is asking the user to allow the 
Setup program to query the program/ application download server 
to obtain license information for the user's equipment in step 
85. If the user does not allow such a query, in step 90 the 
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license management application exits according to an exit 
menu. Such an exit menu may include an instruction to 
manually contact the program/ application download server 
license administrator ( s ) to obtain the correct license file. 
If the user does allow such a query, the licence management 
application continues as shown in Figure 5, which steps will 
be described in more detail further below. 

Continuing, however, with a description of the Setup 
program in Figure 1, if, after the welcome screen in step 5, 
the user chooses in step 10 the floating license server 
installation option, in step 95 a determination as to whether 
flexible license management software (e.g., FlexLM®) is 
installed is made.. If the flexible license management 
software is not installed, in step 100 a license management 
utility installation occurs. The user is queried as to the 
destination directory into which the Setup program should 
install the flexible license management software files onto 
the local host. Upon determination of the directory by the 
user in step 105 the license management application files are 
copied into the destination directory. 

Upon installation 
software, or if in the case 
management software was pre 
determination as to whether 

Referring now to Figure 3, if the license file 
exists, in step 115 a determination is made as to whether the 
license file is valid. That is, a determination is made as to 
whether or not the license file needs to be updated. If the 
license file is not valid, in step 120 a license management 
dialog box is created in which the user is informed that the 
license file is invalid and is asked whether the user would 
prefer to replace it in step 125. If the user does not wish 
to replace the license file, the program exits. If the user 
does in fact wish to replace the license file the Setup 
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of the flexible license management 
that the flexible license 
-installed, in step 110 a 
the license file exists is made. 




program continues with the application as if the license file 
had not existed, as will be described in further detail below 
in reference to Figure 4. 

5 Alternatively, in step 115, if the license file is 

determined to be valid, in step 130 current license 
information is checked. Here the Setup program will detect 
whether a floating and/or node locked license is installed on 
the user equipment. Such information will be presented to the 
10 user, and the user will be asked whether or not to update or 
reload the license in step 135. If the user does not wish to 
update/reload the license file, the program exits. If, as 
before, the user chooses to update the license file, 

£3 programming continues as if there was no license file uploaded 

Kl5 on the server. 

m 

'Z Referring now to Figure 4, in the instance where 

Q there is no license file located on the server (as determined 

!~ in step 110 of Figure 1) or the user desires to update/reload 

M20 and/or replace the license file (as determined in steps 125 
PU and 135, respectively, of Figure 3), in step 140 the Setup 

^ program presents the license management installation options 

?5 to the user. These options consist of an automatic 

installation, an e-mail installation, and/or a manual 
25 installation option. If the user chooses either an e-mail 
and/or manual installation option, in step 145 the Setup 
program presents the user with setup pages for e-mail and/or 
manual installation. If, however, the user chooses the 
automatic installation option, in step 150 the Setup program 
30 requests permission from the user for a database query. Thus 
the user is asked to allow the Setup program to query the 
program/ application download server to request a license file 
for the host in step 155. If the user chooses not to allow 
the Setup program to query the server, the Setup program 
35 returns to step 140 and defaults to the e-mail installation 
option of the license management installation options. 
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If, on the other hand, the user gives permission to 
allow such query of the database, in step 160 a series of 
steps are conducted, as shown in Figure 5, to retrieve and 
install the license file from the program/ application download 
5 server. As mentioned above in regard to step 85 of Figure 1, 
such installation steps of the license file also occur in 
response to an affirmative answer with respect to a permission 
query to allow the Setup program to query the database. 

10 Accordingly, referring now- to Figure 5, the 

procedure for the Setup program to retrieve and install a 
license file from the program/ application download server is 
shown. In step 165 a determination of whether a pin number is 
•;:3 required for security is made. If a pin number is required, 

;2l5 in step 170 the user is presented with a dialog box requesting 
fU the pin number to configure the license management 

% installation. If no pin number is entered, or the user 

C3 desires to cancel, the Setup program exists . If, however, a 

pin number is entered in step 175, a determination of whether 
£320 the pin number is valid is made. If in step 180 it is 
determined that the pin number is invalid, the user is 
i;f • presented with a dialog box stating that the pin number is 
n invalid and to please re-enter the pin number again, as the 

Setup program returns to step 170. 

25 

If it is determined in step 175 that the pin number 
is valid or if it is determined in step 165 that a pin number 
is not required, in step 185 the Setup program queries the 
license database to get the license information for the 

30 computing equipment running the setup program. This consists 
of sending a host ID, customer license number, other relevant 
data, and a request code to the license database. The 
program/ application download server either returns an error 
message to the Setup program or returns the license 

35 information . 

If the license information is returned, in step 190 
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a license configuration entry form, either for floating or 
node locked license management software configuration modes is 
displayed for the user to fill out. The license configuration 
entry form consists of a display of the available license 
products, the number of licenses available, the number of 
licenses currently residing on the host equipment and an edit 
box for any license requests. In step 195, license 
confirmation occurs. License confirmation consists of 
displaying a summary of the license configuration requested by 
the user and how many licenses for each product is to be 
allocated for this machine. In step 200, the updating of the 
license database to obtain the license file occurs. This 
consists of sending license information to the license 
database and returning a license file. Accordingly, in step 
205 the license file is installed to the appropriate location 
in the user/client computing system. 

Referring back to Figure 4, the Setup program, 
having retrieved and installed the appropriate license file 
from the program/application download server and license 
database, in step 210 determines the type of host that the 
current host is. If it is determined that the current host is 
a Windows® type host, in step 215 license management startup is 
conducted. The license management Daemon may start as a 
service, a startup group, and/or a manual startup. In step 
220, the appropriate registry variable is set. Upon proper 
setting of the file in the registry, or if the current host is 
determined to be a Unix® type host, in step 225 the license 
management finishes. In this case, a dialog box is presented 
to the user that states that the license management 
installation has been completed successfully and requests the 
setting of the license management license file path. 

The user has now been provided with the opportunity 
to retrieve, install, and successfully set up a license from 
the program/ application download server and license database. 
Having completed the foregoing steps, dependent upon the 
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initial installation option, the user may utilize the licensed 
program. 

Referring now to Figure 6, the error handling 
facility that is embedded as a library within a license 
managed application program is shown. Thus, when a licensed 
application encounters a license management error, or the 
Setup program application detects a license management error, 
an error processing operation occurs. If an error is 
determined to have occurred, in step 300 a determination of 
whether the error can be corrected by the Setup program is 
conducted. If the error cannot be corrected by the Setup 
program, in step 305 the user is presented with a dialog box 
stating that the current application is unable to obtain a 
license and identifying the particular error. The user is 
further instructed to contact the license administration at a 
particular address and/or phone number. Accordingly, the 
Setup program/licensed application will then exit. 

If it is determined that the error can be corrected 
by the Setup program, the Setup program is invoked and run. 
In step 310 a determination of whether a floating license has 
been and/or is installed is determined. If it is determined 
that installation is a floating license server problem (e.g., ■ 
there is no server running or a license file is not installed) 
or an invalid node locked license installation, in step 315 a 
dialog box is presented to the user stating that the current 
application is once again unable to obtain a license and 
identifying the particular error. Once again, as in step 305, 
the user is instructed to contact their own system 
administrator. The Setup program will then exit. 

If it is determined in step 310 that the license is 
a floating license and that the license installation is one of 
an end user, in step 320 a dialog box is presented to the user 
stating that the current application is unable to obtain a 
license and that the error is (whatever the error determined 
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to be) . The user is further requested as to whether the user 
would like to configure the license management now. If not, 
the Setup program exists. If so, processing continues in step 
20 as shown in Figure 2. 

5 

Referring to Figure 7, a system using the automated 
license management Daemon and license database interface 
within the automated license management installation process 
is shown. A Setup program 700 resides on a user/client 
10 computer system 7 05. The Setup program communicates through 
network 710 (e.g., the Internet/World-Wide-Web) to the 
program/ application download server 740. by means of a post 
request to the appropriate web-server tunneling agent. 

~15 Such request is sent through the network 710 and 

U through a corporate firewall 720 to a port 730. Port 730 is a 

£ port specifically reserved for HTTP protocol requests and 

responses. Firewall 720 filters all requests except through 
ports handling HTTP and FTP protocol message traffic. 

;;120 

; ; y The Setup program post request is passed through a 

^ corporate Intranet 745 to the various corresponding components 

□ of the program/application download server 740. These 

components consist of the license management Daemon 750, the 
25 license installation database 760, a corporate database 770 
(which may, for example, correspond to an Oracle® or Olympus® 
database) and various CGI tunneling agents 780. The license 
management Daemon 750 formats the Setup program's 700 request 
to the license installation database 760. An application of 
30 database 760 then handles the request from the license 

management Daemon 750 and returns the appropriate reply. It 
is to be understood, of course, that the various components of 
serV er 740 are not restricted to residing solely on the server 
and may in fact reside elsewhere (e.g., on other serves or as 
35 stand-alone components) . 

As access to the license installation database 760 
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by the Setup program 700 is in effect direct, the program can 
make changes to the license installation database 760. On the 
other hand, however, changes to the corporate database 770 are 
made manually by sales, license, and key administrators. For 
system integrity, the changes in each database must be 
synchronized in the other such that transactions made on 
either one are replicated in the other, and that manual 
changes to the corporate database 770 itself are reflected 
back to the license installation database 760. 

As modifications can be made to the license 
management configuration in either the automated license 
installation database 760 or the corporate database 770, 
information in the two databases 760, 770 is kept consistent 
with each other through a synchronization strategy. Such 
database synchronization strategy includes: a conflict 
detection and conflict resolution methodology using a time 
stamp sequencing; validation as a prerequisite to any license 
database update; a proactive notification process; a 
matchback methodology to each synchronization source using an 
identical unique ID value of the system; and a second chance 
logic methodology. The component of the database 
synchronization strategy that utilizes the matchback 
methodology to each synchronization source utilizing the same 
unique ID value of the system operates, for instance, 
utilizing a field identifier in which any update made in a 
license record that exists in both the license installation 
database and corporate database, will ensure that a change is 
entered into the correct row in each database. A 
change/transaction is passed between the databases utilizing 
the field ID value to access the record. For example, a 
matchback methodology utilizing a unique ID in the case where 
a table in the corporate database (e.g., a * wrslp_license_ 
keys'' table) is done through an accompanying identification 
field (e.g., a * wrslp_license_key" ID field). An update in 
this example is passed utilizing the ID value to access the 
record . 
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Alternatively, a matchback methodology in an insert 
situation in which there are independent ID' s to access a 
record uniquely in all systems involved means there is no co- 
dependency from ID assignment. That is, if the *wrslp_ 
license key" ID were the unique ID used in both databases, 
every insert situation would require that the inserting 
database retrieved the next value from a pool common to both 
databases. Moreover, at synchronization time, there could be 
the risk of a duplicate ID error. 

The second chance logic component of the database 
logic component of the database synchronization strategy is 
triggered when the update to the site fails because of an 
error other than a data error. A connection failure would 
cause second chance logic to kick in. This facility writes 
out a transaction to be used in re-submission of the 
modification. During the re-submission time-stamp sequencing 
logic is used to determine if the transaction should be 
allowed to go through or be inactivated and flagged for 
administrators' attention . 

With respect to the exemplary embodiment according 
to the present invention, a user/client now has the ability to 
directly access a program/ application download server through 
HTTP tunneling without recourse of a third party web server 
and use of a web browser. Accordingly, such communication and 
downloading is far more timely and secure. 

In the foregoing description, the method and 
apparatus of the present invention have been described with 
re f erencG to a number of examples that are not to be 
considered limiting. Rather, it is to be understood and 
expected that variations in the principles of the method and 
apparatus herein disclosed may be made by one skilled in the 
art and it is intended that such modifications, changes, 
and/or substitutions are to be included within the scope of 
the present invention as set forth in the appended claims. 
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The specification and the drawings are accordingly to be 
regarded in an illustrative rather than in a restrictive 
sense . 
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